/**
 * @(#)PerfilSocial 28/02/2015
 *
 * Copyright (c) 2005-2015 PsiqueWare S.A. de C.V. All Rights Reserved.
 * This software is the proprietary information PsiqueWare S.A. de C.V.
 * Use is subject to license terms.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 *
 * <br/>Usuario : AngelElectrico
 * <br/>Creaci&oacute;n:28/02/2015 - 08:49 PM PM
 * <br/>
 * <br/>
 * <br/><t5>Cambios :</t5>
 * <br/><b>Fecha | Autor  |  Cambios</b>
 * <ul>
 * <li>28/02/2015 | <a href = "mailto:AngelElectrico@PsiqueWare.com">&Aacute;ngel El&eacute;ctrico</a> | Creaci&oacute;n del Objeto.</li>
 *
 * </ul>
 */
package com.psiqueware.alheli.id.dao;

import com.psiqueware.alheli.dao.AlreadyPersistedObjectException;
import com.psiqueware.alheli.dao.DAOException;
import com.psiqueware.alheli.dao.EnlaceTransaccional;
import com.psiqueware.alheli.dao.NotAPersistedObjectException;
import com.psiqueware.alheli.dao.BaseDAO;
import com.psiqueware.alheli.id.PerfilSocial;

import java.util.List;

/**
 * Contrato de operaciones CRUD para el objeto PerfilSocial.
 * <br/>Paquete Original: com.psiqueware.alheli.id.dao
 * <br/>Nombre  Original: PerfilSocialDAO
 * <br/><a href="PerfilSocialDAO.java.html"><i>Ver C&oacute;digo Fuente</i> </a>
 *
 * @author <a href="mailto:AngelElectrico@PsiqueWare.com">&Aacute;ngel El&eacute;ctrico</a>
 * @version Revision: 1.1 28/02/2015 08:49 PM
 * @noinspection DuplicateThrows
 */
public interface PerfilSocialDAO extends BaseDAO
{

    /**
     * Guarda un {@link PerfilSocial} en persistencia.
     * Este {@link PerfilSocial} no debe existir en persistencia o una
     * AlreadyPersistedObjectException debe brotar.
     *
     * @param o                   {@link PerfilSocial} a persistir.
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return {@link PerfilSocial} después de persistirse.
     * <p/>
     * Una AlreadyPersistedObjectException surgir&aacute;
     * en caso de que este {@link PerfilSocial} ya existiera en persistencia.
     *
     * @throws com.psiqueware.alheli.dao.DAOException en caso de un error de persistencia.
     */
    PerfilSocial savePerfilSocial(final PerfilSocial o, final EnlaceTransaccional enlaceTransaccional) throws DAOException;

    /**
     * Actualiza un {@link PerfilSocial} en persistencia.
     *
     * @param o                   PerfilSocial a actualizar.
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return {@link PerfilSocial} actualizado.
     * <p/>
     * Una NotAPersistedObjectException surgir&aacute;
     * en caso de que este {@link PerfilSocial} no existiera en persistencia.
     *
     * @throws com.psiqueware.alheli.dao.DAOException en caso de un error de persistencia.
     */
    PerfilSocial updatePerfilSocial(final PerfilSocial o, final EnlaceTransaccional enlaceTransaccional) throws DAOException;

    /**
     * Devuelve un {@link PerfilSocial} a partir de su id.
     *
     * @param id                  del {@link PerfilSocial} que se busca.
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return {@link PerfilSocial} en caso de encontrarlo, <code>null</code> en otro caso.
     *
     * @throws com.psiqueware.alheli.dao.DAOException si se presenta algún problema.
     */
    PerfilSocial findPerfilSocialPorId(final Long id, final EnlaceTransaccional enlaceTransaccional) throws DAOException;

    /**
     * Elimina un {@link PerfilSocial} del sistema de persistencia.
     *
     * @param o                   {@link PerfilSocial} que se pretende elimninar.
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *                            <p/>
     *                            Una NotAPersistedObjectException surgir&aacute; si dicho objeto no exist&iacute;a en persistencia.
     *
     * @throws com.psiqueware.alheli.dao.DAOException si no se puede comunicar a la base de datos.
     */
    void deletePerfilSocial(final PerfilSocial o, final EnlaceTransaccional enlaceTransaccional) throws DAOException;

    /**
     * Devuelve un listado de los {@link PerfilSocial} que se encuentran en persistencia.
     *
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return {@link java.util.List} de {@link PerfilSocial} en caso de encontrar alguna; una {@link java.util.List} vacia en caso contrario.
     *
     * @throws com.psiqueware.alheli.dao.DAOException si se presenta alg&uacute;n problema.
     */
    List<PerfilSocial> listPerfilSocial(final EnlaceTransaccional enlaceTransaccional) throws DAOException;

    /**
     * Devuelve un listado de los {@link PerfilSocial} que se encuentran en persistencia.
     *@param idUsuario identificador &uacute;nico del {@link Usuario} al que pertenecen los {@link PerfilSocial}.
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return {@link java.util.List} de {@link PerfilSocial} en caso de encontrar alguna; una {@link java.util.List} vacia en caso contrario.
     *
     * @throws com.psiqueware.alheli.dao.DAOException si se presenta alg&uacute;n problema.
     */
    List<PerfilSocial> listPerfilSocialPorIdUsuario(final Long idUsuario,final EnlaceTransaccional enlaceTransaccional) throws DAOException;

}
